home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / dev / basic / hsb_wbs_inc.lha / hsb_wbs_inc / bh / wbstart.bh < prev   
Text File  |  1996-08-15  |  2KB  |  80 lines
  1. REM wbstart.bh, shared library basic header file
  2. REM wbstart © 1991-96 Stefan Becker
  3. REM HiSoftBasic-Anpassung von Steffen Leistner
  4.  
  5. REM $INCLUDE wbstart.bc
  6. LIBRARY DECLARE "wbstart.library"
  7.  
  8. DECLARE FUNCTION WBStartTagList& LIBRARY     'Taglist
  9.  
  10. '    NAME
  11. '        WBStartTagList -- Start a program as WB program
  12.  
  13. '    SYNOPSIS
  14. '        success& = WBStartTagList&(taglist)
  15. '    FUNCTION
  16. '        Start a file as WB program.
  17.  
  18. '        The following tags are currently supported. All information is copied
  19. '        so you can free the resources after the library call.
  20.  
  21. '        WBStart_Name&            (SADD)
  22.  
  23. '        Name of the file to start. It may be the name of a program, a tool
  24. '        or a project. IF the name does not contain an absolute path name
  25. '        then the file will be searched relative to WBStart_DirectoryName&
  26. '        or WBStart_DirectoryLock&.
  27.  
  28. '        This tag must be specified. Otherwise WBStartTagList&() will fail.
  29.  
  30.  
  31. '        WBStart_DirectoryName&   (SADD)
  32.  
  33. '        Name of a directory where the search for WBStart_Name& starts.
  34. '        Mutually exclusive to WBStart_DirectoryLock&.
  35.  
  36.  
  37. '        WBStart_DirectoryLock&   (BPTR)
  38.  
  39. '        Lock of a directory where the search for WBStart_Name& starts.
  40. '        Mutually exclusive to WBStart_DirectoryName&.
  41.  
  42. '        If neither WBStart_DirectoryName& or WBStart_DirectoryLock& is
  43. '        specified then the current directory of the internal handler
  44. '        will be used. WBStart_Name& should contain an absolute path name
  45. '        in this case.
  46.  
  47.  
  48. '        WBStart_Stack&           (ULONG)
  49.  
  50. '        Stack size of the new process. A larger stack setting in the tool
  51. '        or project icons overrides this value.
  52. '        Default: 4096 Bytes
  53.  
  54.  
  55. '        WBStart_Priority&        (LONG)
  56.  
  57. '        Priority of the new process.
  58. '        Default: 0
  59.  
  60.  
  61. '        WBStart_ArgumentsCount&  (ULONG)
  62.  
  63. '        Number of arguments in the list specified by WBStart_ArgumentList&.
  64. '        Default: 0
  65.  
  66.  
  67. '        WBStart_ArgumentList&    (VARPTR(STRUCT WBArg&))
  68.  
  69. '        Pointer to an array of Workbench arguments. This list will be
  70. '        appended to the argument list for the tool.
  71.  
  72. '        If a list is specified then WBStart_ArgumentsCount must be
  73. '       specified too, otherwise WBStartTagList&() will fail.
  74. '        Default: NULL&, i.e. no argument list
  75.  
  76. '    INPUTS
  77. '        tagslist - list of TagItems
  78.  
  79. '    RESULTS
  80. '        success& - RETURN_OK& if the program could be started